home *** CD-ROM | disk | FTP | other *** search
/ Aminet 41 / Aminet 41 (2001)(Schatztruhe)[!][Feb 2001].iso / Aminet / util / arc / xadmaster020.lha / xad / Docs / xadUnFile.doc < prev    next >
Text File  |  2000-12-03  |  7KB  |  196 lines
  1. NAME
  2.     xadUnFile 1.20
  3.     xadUnFileM 1.20
  4.  
  5. SYNOPSIS
  6.     xadUnFile FROM/A,DEST=DESTDIR,PASSWORD/K,FILE/M,NAMESIZE/K/N,
  7.     FFS=OFS/S,SFS/S,INFO=LIST/S,Q=QUIET/S,AM=ASKMAKEDIR/S,OW=OVERWRITE/S,
  8.     SP=SHOWPROT/S,VERBOSE/S,DARC=DISKARCHIVE/S,ENTRY/K/N,DIMG=DISKIMAGE/S,
  9.     NA=NOABS/S,NC=NOCOMMENT/S,ND=NODATE/S,NE=NOEXTERN/S,NKP=NOKILLPART/S,
  10.     NP=NOPROT/S,NT=NOTREE/S
  11.  
  12.     xadUnFileM FROM/A/M,DEST=DESTDIR/K,PASSWORD/K,FILE/K,NAMESIZE/K/N,
  13.     FFS=OFS/S,SFS/S,INFO=LIST/S,Q=QUIET/S,AM=ASKMAKEDIR/S,OW=OVERWRITE/S,
  14.     SP=SHOWPROT/S,VERBOSE/S,DARC=DISKARCHIVE/S,ENTRY/K/N,DIMG=DISKIMAGE/S,
  15.     NA=NOABS/S,NC=NOCOMMENT/S,ND=NODATE/S,NE=NOEXTERN/S,NKP=NOKILLPART/S,
  16.     NP=NOPROT/S,NT=NOTREE/S
  17.  
  18. DESCRIPTION
  19.     xadUnFile is the master shell tool to extract data from
  20.     file archives.
  21.  
  22.     FROM specifies the file archive that should be handled.
  23.     The xadUnFileM tool can handle splitted archives, when they are
  24.     given in their correct order. Do not give multiple names of
  25.     single archives! You may use patterns with xadUnFileM.
  26.  
  27.     DESTDIR is the destination directory. The directory is created
  28.     when it does not exist (except if ASKMAKEDIR is turned on and
  29.     you select no). There are some dangerous archives using absolute
  30.     path names (e.g. starting with LIBS: or RAM:). xadUnFile archives
  31.     these files to their absolute position (except NOTREE or NOABS is
  32.     used). For xadUnFileM this argument requires the keyword DEST or
  33.     DESTDIR.
  34.  
  35.     PASSWORD can be used to supply a password for unarchiving of
  36.     encrypted archives. This argument requires the keyword PASSWORD.
  37.  
  38.     FILE allows you to select filename(s) (including patterns), which
  39.     should be extracted. When FILE is not given, all files are
  40.     extracted. With FILE only matching files are extracted.
  41.     NOTE: When you do not use NOTREE keyword, the patterns check
  42.     includes checks for directory structure as well.
  43.     For xadUnFileM there are some special rules:
  44.       To pass multiple names, use patterns like (xxx|yyy|zzz), where
  45.       xxx, yyy and zzz are three file names. You cannot pass multiple
  46.       strings like for xadUnFile. And additionally this argument
  47.       requires the keyword FILE.
  48.  
  49.     NAMESIZE allows to specify the maximum size of a filename. This is
  50.     useful as some archives from unix machines have longer filenames
  51.     than the Amiga filesystem allows. Whenever a name is longer than
  52.     the namesize value, you are asked to enter a shorter name. Names
  53.     of directories are truncated without requests.
  54.     FFS or OFS replace NAMESIZE argument and provide a standard length
  55.     of 30 characters, which is the value of our standard file system.
  56.     SFS provide a length of 100 characters, the SmartFilesystem
  57.     standard.
  58.  
  59.     NOEXTERN prohibits the use of external clients for
  60.     recognition purposes.
  61.     
  62.     INFO or LIST prints information about the archive and does not
  63.     do any unarchiving. SHOWPROT turns on display of protection
  64.     information. VERBOSE shows additional information texts, which
  65.     exist for some archivers.
  66.     
  67.     OVERWRITE forces the program to overwrite an already existing
  68.     destination file. Normally you are asked about that.
  69.     
  70.     NOTREE skips all directory names and writes the files directly to
  71.     destination directory.
  72.     
  73.     ASKMAKEDIR forces the program to ask you, if a missing directory
  74.     should be created.
  75.     
  76.     NOCOMMENT prevents setting archived file comments, NOPROT prevents
  77.     setting file protection bits and NODATE prevents setting date
  78.     information. NOCOMMENT also prevents displaying comment lines with
  79.     INFO or LIST keyword.
  80.     
  81.     NOABS prevents creation of absolute path names.
  82.  
  83.     If you specify NOKILLPART keyword, partial or corrupt output files
  84.     no longer are deleted.
  85.  
  86.     The QUIET option turns off the progress report, but also disables
  87.     questions to skip, rename or overwrite files.
  88.  
  89.     The tool allows to extract files from disk images. If you specify
  90.     DISKIMAGE, the input file is handled as disk image (ADF file)
  91.     and not as file archive. If it is an valid Amiga filesytem disk,
  92.     files can be extracted from it. Specifying DISKARCHIVE is like
  93.     DISKIMAGE, but input data is an disk archive, which is dearchived
  94.     before extracting files. If the disk archive has multiple entries,
  95.     you may use ENTRY keyword to specify the wanted entry.
  96.  
  97. EXAMPLES
  98.     Shell> xadUnFile archive.tar RAM:
  99.         Unarchive the tar archive to RAM:
  100.  
  101.     Shell> xadUnFile archive.lha RAM: #?.txt #?.doc Contents
  102.         Unarchive all .txt and .doc file and the file "Contents" of
  103.         lha archive to RAM:
  104.  
  105.     Shell> xadUnFileM archive.lha DEST RAM: FILE (#?.txt|#?.doc|Contents)
  106.         The same call for xadUnFileM
  107.  
  108.     Shell> xadUnFile archive.lha LIST
  109.         Tells information about archive.lha file.
  110.  
  111.     Shell> xadUnFile image.adf DIMG LIST
  112.         Tells information about files in disk image image.adf.
  113.  
  114.     Shell> xadUnFileM archive.lha archive.l[0-9]? LIST
  115.         Tells information about splitted lha archive.
  116.  
  117. HISTORY
  118.     xadUnFile 1.20, xadUnFileM 1.20
  119.     - bug fixes with multiple filesystem support
  120.  
  121.     xadUnFile 1.19, xadUnFileM 1.19
  122.     - The program uses new V7 feature and scans for multiple filesystems.
  123.  
  124.     xadUnFile 1.18, xadUnFileM 1.18
  125.     - After extraction a short status is reported.
  126.  
  127.     xadUnFile 1.17, xadUnFileM 1.17
  128.     - added support for archives with unknown decrunched size
  129.  
  130.     xadUnFile 1.16, xadUnFileM 1.16
  131.     - bug fixes
  132.  
  133.     xadUnFile 1.15, xadUnFileM 1.15
  134.     - added support for patterns in xadUnFileM
  135.  
  136.     xadUnFile 1.14, xadUnFileM 1.14
  137.     - added DISKARCHIVE, DISKIMAGE and ENTRY parameters
  138.     - bug fixes
  139.  
  140.     xadUnFile 1.13, xadUnFileM 1.13
  141.     - added VERBOSE parameter
  142.  
  143.     xadUnFile 1.12, xadUnFileM 1.12
  144.     - added NOKILLPART parameter
  145.  
  146.     xadUnFile 1.11, xadUnFileM 1.11
  147.     - added SFS parameter
  148.  
  149.     xadUnFile 1.10, xadUnFileM 1.10
  150.     - added NAMESIZE and FFS or OFS parameters
  151.  
  152.     xadUnFile 1.9, xadUnFileM 1.9
  153.     - Now also sets protection bits and comment for directories. The
  154.       date is correct for empty dirs only, as the OS automatically
  155.       updates the date, if something is changed in the directory.
  156.  
  157.     xadUnFile 1.8, xadUnFileM 1.8
  158.     - Also strips "/" or ":" at name start for NOABS option.
  159.  
  160.     xadUnFile 1.7, xadUnFileM 1.7
  161.     - new options SHOWPROT and QUIET
  162.     - normal xadUnFile got back style of 1.4 and the multifile archive
  163.       style has been implemented in the special xadUnFileM tool.
  164.       Splitted archives are very seldom and it is of no use to make the
  165.       shell arguments that complicated for single file archives.
  166.  
  167.     xadUnFile 1.6
  168.     - added multiple input file support and renaming
  169.  
  170.     xadUnFile 1.4
  171.     - no longer aborts when unarchiving failed for one entry
  172.     - added NOABS option and comment display with INFO
  173.  
  174.     xadUnFile 1.3
  175.     - added size output for "group archivers" like LzX
  176.  
  177.     xadUnFile 1.2
  178.     - added output for corrupted files
  179.  
  180.     xadUnFile 1.1
  181.     - added FILE parameter and directory creation
  182.  
  183.     xadUnFile 1.0
  184.     - First public release.
  185.  
  186. COPYRIGHT
  187.     xadUnFile is freely distributable for noncommercial use.
  188.  
  189. AUTHOR
  190.     Dirk Stöcker
  191.     Geschwister-Scholl-Straße 10
  192.     01877 Bischofswerda
  193.     GERMANY
  194.     
  195.     Dirk Stoecker <stoecker@amigaworld.com>
  196.